Tasten & Command Beschreibung
=============================


Command-Gruppe "CLIP": Zwischenablage
=====================================

RK bietet eine Reihe von Commands, die den Inhalt der Zwischenablage
manipulieren.
Die Zwischenablage wird in diesem Kapitel kurz "Clip" genannt.


/CLIP.CALC [mod] ......: Berechnet den Inhalt der Zwablage (wenn als Liste vorh.), <mod>=1: Durchschnitt
------------------------
Wenn Zahlen in der Zwablage in Listenform vorliegen, kann dieser Command das Ergebnis
berechnen. I.d.R wird es sich um Addition und Subtraktion handeln, mglich sind aber auch
Multiplikation (*) und Division (/) und Prozent (% - mu am Zeilenende stehen).
Theoretisch mglich ist auch Potenzierung (^), Wurzel (v) und 1/x Berchnung (\).
Ist kein Operator angegeben, so wird Addition vorausgesetzt.
Kommas werden in erforderliche Punkte gewandelt, nur fr die Ausgabe wird das Komma, sofern
in den Lndereinstellungen von Windows eingestellt, wieder ausgegeben.
Ab v7.7.61 ist ClipCalc ein eigenstndiges Programm und gestattet den Parameter <mod>=1, der
eine Durchschnitts-Berechnung durchfhrt.

Beispiel:
Richten Sie einen Knopf mit folgendem Inhalt ein:

{/BTCH.EXPLICIT}
{/CLIP.CALC}
{/CLIP.TXT.VIEW}

Dann kopieren Sie folgenden Block in die Zwischenablage

 44.50
 17.33
112.05

und klicken den neu eingerichteten Knopf einmal an.

--> Tip
Das funktioniert auch, wenn Sie z.B. in Excel eine Spalte in die Zwablage kopieren.

--> Hinweis
Das Ergebnis der Berechnung wurde zustzlich der aktuellen Variablen VAR zugewiesen.
Somit knnen mit den VAR-Commands Folge-Berechnungen durchgefhrt werden.

--> Hinweis
Das Profil "Script-Calculator" basiert auf diesem Prinzip. Es kann also mit Hilfe dieses
Commands ein kompletter Taschenrechner mit der RK-Script-Language programmiert werden.


/CLIP.CLEAR ...........: Lscht das Clip
------------------------

Beispiel: {/CLIP.CLEAR}


/CLIP.COPYPATH ........: Kopiert einen Pfad ins Clip
------------------------

Beispiel: {/CLIP.COPYPATH}


/CLIP.IMG.LOAD file....: Liest ein Bild <file> ins Clip ein
------------------------
Mittels diesem Command kann man ein Bild (bmp, jpg, gif) ins Clip einlesen,
das dann anschlieend zwecks Einfgen in eine Anwendung zur Verfgung steht.

Beispiel: {/CLIP.IMG.LOAD c:\work\myface.jpg}


/CLIP.IMG.MEM no ......: Lies das Bild Nr. <no> (1-10) des "Speicher fr Bilder" ins Clip ein
------------------------
Die Funktion "Speicher fr Bilder" (bitte dort nachlesen) kann bekanntlich 10
Bilder beherbergen. Dieser Command gestattet es, eines der 10 Bilder dieser
Funktion ins Clip einzulesen.

Beispiel: {/CLIP.IMG.MEM 10}


/CLIP.IMG.VIEW ........: Zeigt das in der Zwablage befindliche Bild im internen Bildbetrachter an
------------------------

Beispiel: {/CLIP.IMG.VIEW}


/CLIP.TXT.APPEND file .: Fgt den Inhalt der Zwablage der Datei <file> hinzu
------------------------

Beispiel: {/CLIP.TXT.APPEND c:\test.txt}


/CLIP.TXT.ASK .........: Gestattet es, whrend der Skript-Abarbeitung der Zwablage einen Text zuzuweisen
------------------------

Beispiel: {/CLIP.TXT.ASK}

--> Tip
Wird der Dialog durch "Abbrechen" geschlossen, so kann die Skript-Abarbeitung
an dieser Stelle durch den Commands "BTCH.EXIT-ON-CANCEL" (siehe dort) beendet
werden.


/CLIP.TXT.BEFOR txt....: Fgt den Text <txt> an den Anfang des Clips ein
/CLIP.TXT.BEHND txt....: Hngt den Text <txt> an das Ende des Clips an
------------------------
Mit diesen Commands kann man nicht nur den Inhalt des Clips mit Text erweitern,
sondern auch einen Text ins Clip kopieren, soda der bisherige Inhalt komplett
ersetzt wird.

Beispiel: {/CLIP.CLEAR}{/CLIP.TXT.BEFOR Text-Beispiel}

In diesem Beispiel steht nur noch der Text "Text-Beispiel" im Clip.

Beispiel:
{/CLIP.TXT.BEFOR Zeile1
Zeile2}

Zeilenumbrche, wie in diesem Beispiel, sind auch mglich.


/CLIP.TXT.BEHND.ASC [no] Hngt das ASCII-Zeichen <no> an das Ende der Zwablage an (Vorgabe VAR)
/CLIP.TXT.BEHND.ASK ...: Gestattet es, whrend der Skript-Abarbeitung der Zwablage einen Text anzuhngen
/CLIP.TXT.BEHND.CR ....: Hngt ein Carriage Return (neue Zeile) an das Ende der Zwablage an
/CLIP.TXT.BEHND.MEM ...: Hngt den RK-ClipMemory an das Ende der Zwablage an
/CLIP.TXT.BEHND.STR [n]: Hngt die Variable STR <n> an das Ende der Zwablage an (Vorgabe VAR)
/CLIP.TXT.BEHND.VAR ...: Hngt die aktuelle Variable VAR an das Ende der Zwablage an
------------------------

--> Tip
Mit dem -.ASC Command lt sich eine Konvertierung von einem Wert in ein Zeichen vornehmen.
In Basic wrde die Formel theoretisch so aussehen:
clip=clip+CHR$(VAR).
Dies erreicht man, indem man der VAR einen Wert zuweist und den Parameter [no] einfach weglt.

Beispiel:

{/BTCH.EXPLICIT}
{/VAR.SET 65}
{/CLIP.CLEAR}
{/CLIP.TXT.BEHND.ASC}
{/CLIP.TXT.SEND}

In diesem Beispiel wird der Buchstabe "A" ausgegeben, da er dem ASCII-Code 65 entspricht.


/CLIP.TXT.BLOCK.BEGIN .: Markiert den Anfang eines Blocks im Skript, der in die Zwablage kopiert wird
/CLIP.TXT.BLOCK.END ...: Markiert das Block-Ende fr CLIP.TXT.BLOCK.BEGIN (optional, andernfalls Text-Ende)
------------------------
Diese Commands gestatten es, einen Textblock im Skript in die Zwischenablage zu kopieren.
Der BLOCK.END-Command ist nicht zwingend erforderlich. Fehlt er, so wird automatisch
das Skript-Ende als Block-Ende gesetzt.

Beispiel:
{/CLIP.TXT.BLOCK.BEGIN}
Zeile 1
Zeile 2

Beispiel:
{/CLIP.TXT.BLOCK.BEGIN}
Zeile 1 und
Zeile 2 kommen aus dem Clip,{/CLIP.TXT.BLOCK.END}
{/BTCH.EXPLICIT}
{HOLD.CONTROL}v
{KEY.ENTER}
Zeile 3 wird gesendet.

-> Beachte!
Ein vorangestellter BTCH.EXPLICIT-Command fhrt sicher zu ungewollten Ergebnissen,
da er die CRs aus dem Skript entfernt.

-> Tip
Diese Command-Kombination kann auch dazu verwendet werden, einen Block innerhalb
eines Skriptes zu markieren, der nicht gesendet werden soll.

Beispiel:

Diese Zeile wird gesendet.
{/CLIP.TXT.BLOCK.BEGIN}
Diese Zeile wird nicht gesendet
{/CLIP.TXT.BLOCK.END}Diese Zeile wird wieder gesendet.

Optisch wre es sicher schner, vor der 3. Zeile einen Zeilenumbruch zu machen,
dadurch wrde aber ein vermutlich ungewollter Carriage Return (CR) gesendet werden.
Bitte bedenken, da dadurch die Zwischenablage neu beschrieben wird.


/CLIP.TXT.CONV [mod] ..: Konvertiert Wert/Text in Zwablage, <mod>=0: dec>hex, <mod>=1: hex>dec (Vorg. 0)
------------------------

Beispiel: {/CLIP.TXT.CONV 0}

Steht in der Zwablage die Zahl 234, so steht nach Aufruf dieser Funktion der Text "EA" dort.
Da Modus "0" der Vorgabewert ist, htte es auch der Command {/CLIP.TXT.CONV} getan.


/CLIP.TXT.COUNT .......: Zhlt die im Clip befindlichen Buchstaben
-------------------------
In vielen Internet-Formularen ist die Eingabe auf eine bestimmte Anzahl von
Zeichen beschrnkt. Wenn Texte fr unterschiedliche Formulare vorverfat
werden, ist es sehr hilfreich, die Zeichenanzahl dieser Texte schnell zu
ermitteln: Einfach ins Clip kopieren und diesen Command aufrufen.

Beispiel: {/CLIP.TXT.COUNT}


/CLIP.TXT.CUT.LEFT [qu]: Lscht <qu> Zeichen von links der Zwablage (Vorg. VAR) (-qu=len-qu)
/CLIP.TXT.CUT.RGHT [qu]: Lscht <qu> Zeichen von rechts der Zwablage (Vorg. VAR) (-qu=len-qu)
/CLIP.TXT.CUT.FROM [pos] Lscht den Text rechts ab Zeichen-Postition <pos> der Zwablage (Vorg. VAR) (-qu=len-qu)
/CLIP.TXT.CUT.REVERSE .: Wechselt zwischen Zwablage und Umkehrung der letzten .CUT. Opperation
------------------------
Dies ist eine von Basic her bekannte Art des Left$() und Right$() Commands.
Mid$() kann auch realisiert werden, indem Left$() vorausgeschickt wird.
Wird <qu> bzw. <pos> nicht angegeben, so wird der Wert der aktuellen VAR eingesetzt.

Beispiel:

{/BTCH.EXPLICIT}        ; unterdrckt CR (also erlaubt Zeilenumbrche wie hier)
{/STR.SET 1,1234567890} ; weist STR1 den Text "1234567890" zu
{/STR.CLIP.SET 1}       ; kopiert STR 1 in die Zwablage
{/CLIP.TXT.CUT.LEFT 3}  ; Schneidet 3 Zeichen links ab (123 geht weg)
{/CLIP.TXT.CUT.FROM 5}  ; Schneidet alles ab Pos. 5 ab (inkl. dem 5. Zeichen)
{/STR.CLIP.GET 1}       ; schreibt die Zwablage wieder in STR1 zurck
{/STR.VIEW}             ; zeigt (u.a.) STR1 an

Der Anzeiger gibt hier den Inhalt "4567" fr STR1 aus.


Ab v8.0 ist ein negativer qu-Parameter mglich. In diesem Fall berechnet sich qu neu aus der
Differenz zwischen der Gesamtlnge der Zwablage und qu.
Das bedeutet: Stehen 10 Zeichen in der Zwablage und es wird der Parameter -3 angegeben, so
wird aus qu nun 7.

Der ebenfalls ab v8.0 zur Verfgung stehende REVERSE-Command wechselt zwischen dem durch einen
CUT-Command erzeugten abgeschnittenen Teil und dem daraus resultierenden gelschten Teil der Zwablage.
Ohne einem vorangegagenen CUT-Command hat dieser Command also keine Wirkung.
Beispiel: In der Zwablage steht "1234567890". Nun werden mittels des CUT.LEFT-Commands die ersten 4
Zeichen gelscht. In der Zwablage steht nun "567890". Wird nun der REVERSE-Commd aufgefhrt, so
ndert sich der Inhalt der Zwablage in "1234"; also in den zuvor gelschten Teil.
Erneutes Ausfhren des Commands stellt den Urzustand wieder her, weswegen er eigentlich "REVERSE.SWAP"
heien mte, aufgrund der Lnge aber darauf verzichtet wurde.


/CLIP.TXT.ENCRYPT .....: Verschlsselt den im Clip befindlichen Text
/CLIP.TXT.DECRYPT .....: Entschlsselt den im Clip befindlichen Text
------------------------
Die Crypt-Funktion wurde zum verschlsseln von Skript-Inhalten in RK
implementiert (s. "Verschlsselt"-Checkbox in "Bearbeiten > Knpfe").
Da diese Module nun schonmal vorhanden waren, war es wenig Aufwand, sie
fr das Ver- und Entschlsseln von Texten im Clip bereitzustellen.
Mchte man einen ASCII-Text verschlsselt auf HD ablegen, so kopiert man
ihn ins Clip, verschlsselt ihn unter Eingabe eines Pawortes (= Kodierungs-
schlssel, wird von RK automatisch abgefragt), und fgt ihn anschlieend
verschlsselt in die Anwendung zurck.
Nun kann man den Text abspeichern.
Mchte man ihn wieder lesbar machen, kopiert man ihn abermals ins Clip,
endschlsselt ihn unter Eingabe des selben Pawortes und kopiert ihn in
eine Text-Anwendung.
Achtung, bei Verlust des Pawortes scheint es unmglich, den Text jemals
wieder lesbar zu machen!

Beispiel: {/CLIP.TXT.ENCRYPT}


/CLIP.TXT.EDITOR ......: Gibt den Inhalt der Zwablage (nur Text) im Editor aus
------------------------

Beispiel: {/CLIP.TXT.EDITOR}


/CLIP.TXT.END>FRONT [s]: Setzt das durch Leerzeichen getrennte Ende nach vorn, optional mit Trennzeichen <s>
/CLIP.TXT.FRONT>END [s]: Setzt den durch Leerzeichen getrennten Anfang nach hinden, opt. mit Trennz <s>
------------------------
Diese Commands sind z.B. in der Lage, in der Zwablage befindliche Namens-Listen zu drehen.

Beispiel

Liza Minelli
Johann Sebastian Bach

wird zu

Minelli, Liza
Bach, Johann Sebastian

und bei Bedarf zurck in den Ursprung.

Die dazugehrigen Skripts sehen so aus:

{/BTCH.EXPLICIT}          ; Listen-Darstellung fr dieses Skript gestatten
{/CLIP.TXT.END>FRONT ,}   ; Letztes Wort nach vorn stellen, durch Komma getrennt
{/CLIP.TXT.BEHND.CR}      ; Am Ende der Zwablage neue Zeile ffnen
{/CLIP.TXT.SEND}          ; Zwablage senden

und

{/BTCH.EXPLICIT}
{/CLIP.TXT.REMOVE.TXT ,}  ; Smtliche Kommas in der Zwablage entfernen
{/CLIP.TXT.FRONT>END}     ; Erste Wort nach hinten stellen
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

--> Beachte!
Nochmals, damit es deutlich wird:
Es knnen sowohl einzelne Namen, als auch ganze Namens-Listen in einem Durchgang gedreht werden.

--> Tip!
Stellt man vor die Wandlung den Command {/CLIP.TXT.TAB>SPC 1}, so lassen sich auch aus
Excel kopierte Spalten umstellen.


/CLIP.TXT.FORMAT.DO ...: Formatiert eine in der Zwablage befindliche Kalkulations-Liste
/CLIP.TXT.FORMAT.SET [n] Definiert Formatierungs-Modus, <n> (-1,0,1,2,3...): -1=aus, 0=bndig, 2= 0.00 etc.
/CLIP.TXT.FORMAT.SYM txt Fgt Whrungs- Symbol hinzu, <txt> fr $ etc, off=aus, del=lscht aktuelle Symbole
------------------------
Diese Commands wurden fr die formatierte Ausgabe des Script-Calculator-Profils entwickelt.
Falls man das dort im ClipMonMini (CMM) sichtbare Ergebnis anderwrtig gebrauchen kann,
steht der Benutzung dieser Commands natrlich nichts entgegen. 

Beispiel-Skript:

{/BTCH.EXPLICIT}
{/APP.ACTIVATION.OFF}
{/CLIP.TXT.FORMAT.SYM del} ; lscht event. vorhandene Symbole
{/CLIP.TXT.FORMAT.SET 2}   ; schaltet auf Format #.00
{/CLIP.TXT.FORMAT.DO}      ; formatiert die Ausgabe
{/CLIP.TXT.FORMAT.SYM EUR} ; definiert EUR als Whrungs-Symbol
{/CLIP.TXT.FORMAT.DO}      ; formatiert die Ausgabe


/CLIP.TXT.INITIAL [str]: Konvertiert den jeweils 1. Buchst nach Leerzeichen, TAB & CR in Grobuchst
------------------------

Beispiel: {/CLIP.TXT.INITIAL}

Aus dem Satz "abc def, ghi" wird "Abc Def, Ghi".

Ab v8.2 kann optional ein Zeichenketten-Parameter angegeben werden, der weitere
Zeichen auer Leerz, TAB & CR bercksichtigt.
Ohne Parameter macht der Command aus "hans-peter" > "Hans-peter", da der
Bindestrich unbercksichtigt bleibt.
Um "Hans-Peter" zu erzeugen sieht der Command so aus: {/CLIP.TXT.INITIAL -}.
Man kann beliebig viele Zeichen hinzugeben, z.B. {/CLIP.TXT.INITIAL -.,}.


/CLIP.TXT.LOAD file....: Liest einen Text <file> ins Clip ein
------------------------
Mittels diesem Command kann man einen ASCII-Text ins Clip einlesen, der dann
anschlieend zwecks Einfgen in eine Anwendung zur Verfgung steht.

Beispiel: {/CLIP.TXT.LOAD c:\docs\myhistory.txt}


/CLIP.TXT.LOWCASE .....: Wandelt den im Clip befindlichen Text in Kleinbuchstaben
/CLIP.TXT.UPCASE ......: Wandelt den im Clip befindlichen Text in Grobuchstaben
------------------------

Beispiel: {/CLIP.TXT.LOWCASE}


/CLIP.TXT.MEM.COPY ....: Kopiert den Text der Zwablage in den RK-ClipMemory
/CLIP.TXT.MEM.SWAP ....: Schaltet zischen dem Text der Zwablage und dem des RK-ClipMemory hin und her
------------------------
RK besitzt einen Speicher fr die Zwischenablage, genannt ClipMemory. Mit dem Copy-Command
wird der aktuelle Inhalt der Zwablage dort hineingeschrieben, wogegen der SWAP-Command die
Inhalte der Zwablage und des Speichers austauscht.

Beispiel: {/CLIP.TXT.SWAP}

--> Beachte !
Nach dem ersten Aufruf ist die Zwablage natrlich leer, da der "Swap"-Speicher ja noch
unbeschrieben war.

Also folgendermaen vorgehen:
1. Text markieren und in die Zwablage kopieren
2. /CLIP.TXT.SWAP aufrufen
3. Anderen Text markieren und in die Zwablage kopieren
2. /CLIP.TXT.SWAP erneut aufrufen 

Nun stehen mittels /CLIP.TXT.SWAP 2 unterschiedliche Texte in der Zwablage zum Abruf bereit.


/CLIP.TXT.REMOVE.ASC ..: Entfernt die Zeichen mit dem ASCII- Code <no> aus der Zwablage
/CLIP.TXT.REPLACE.ASC .: Ersetzt in Zwablage die ASCII- Zeichen des 1. Param. durch den des 2. Param.
------------------------

Beispiel: {/CLIP.TXT.REMOVE.ASC 34}

In diesem Beispiel werden smtliche Anfhrungszeichen im Clip gelscht.

Beispiel: {/CLIP.TXT.REPLACE.ASC 45,61}

In diesem Beispiel werden smtliche Bindestriche im Clip durch Gleichheits-
zeichen ersetzt.

Im App-Ordner des RK-Ordners befindet sich das Tool "CheckASC", mit dessen Hilfe
man die ASCII-Codes fr die Zeichen ermitteln kann.


/CLIP.TXT.REMOVE.ASK ..: Gestattet das Entfernen eines definierbaren Zeichens oder Textes
/CLIP.TXT.REPLACE.ASK .: Gestattet das Ersetzen  eines definierbaren Zeichens oder Textes
------------------------
Diese beiden Commands ffnen ein Dialog-Fenster, indem die gewnschten nderungen
vorgenommen werden knnen.
Nhere Hinweise findet man auch im Manual-Text "Speicher fr Zwischenablage".

Beispiel: {/CLIP.TXT.REMOVE.ASK}
Beispiel: {/CLIP.TXT.REPLACE.ASK}


/CLIP.TXT.REMOVE.TXT ..: Entfernt die Texte mit Inhalt <txt> aus der Zwablage
/CLIP.TXT.REPLACE.TXT .: Ersetzt in Zwablage die Texte des 1. Param. durch den des 2. Param.
------------------------

Beispiel: {/CLIP.TXT.REMOVE.TXT anm.: }

In diesem Beispiel werden nicht nur die Texte "anm.: " aus der Zwablage entfernt, sondern auch
z.B. "Anm.: ".

Beispiel: {/CLIP.TXT.REPLACE.TXT profesor,Professor}

Dieses Beispiel ersetzt alle "Profesor" durch "Professor".


/CLIP.TXT.SAVE file ...: Speichert den Inhalt der Zwablage in der Datei <file>
------------------------
Diesen Command kann man auch nutzen, um den Inhalt einer Textdatei in Zusammenwirken
mit /CLIP.CLEAR zu lschen, um sie z.B. fr /CLIP.TXT.APPEND vorzubereiten.

Beispiel: {/CLIP.TXT.SAVE c:\test.txt}


/CLIP.TXT.SEND ........: Sendet den im Clip befindlichen ASCII-Text
------------------------
Dies funktioniert hnlich dem Windows-Einfgen per [Strg]+[v], allerdings sendet
der Command den Text auch, wenn die Windows-Einfge-Option ungeeignet erscheint.

Beispiel: {/CLIP.TXT.SEND}


/CLIP.TXT.SET txt .....: Weist der Zwablage den Text <txt> zu
------------------------

Beispiel: {/CLIP.TXT.SET http://www.freewarehits.de}


/CLIP.TXT.TAB>SPC no ..: Konvertiert Tabs zu <no> Leerzeichen in der Zwablage
------------------------

Beispiel: {/CLIP.TXT.TAB>SPC 8}


/CLIP.TXT.TRIM ........: Lscht Leerzeichen und CR vor und nach dem im Clip befindlichen Text
------------------------
Dieser Command kann recht ntzlich sein, wenn etwas ungnstig formatiertes in
das Clip kopiert wurde, wie es z.B. oft bei Webseiten der Fall ist.

Beispiel: {/CLIP.TXT.TRIM}

--> Tip
Zum Korrigieren von schlecht formatieren Text aus Webseiten steht auf
freewarehits.de die Freeware-Tools "Copy & Trim" und "ClipEd" als Bestandteile des
"ToolsPackage" zum Download bereit.


/CLIP.TXT.VIEW ........: Zeigt den Inhalt der Zwablage (nur Text) im internen Textbetrachter an
------------------------

Beispiel: {/CLIP.TXT.VIEW}
